We don’t talk about Quarto

We don’t talk about Quarto

We don’t talk about Quarto

Others had more questions…

What is a “Quarto”?

What is a “Quarto”?¹

Ok, but what IS Quarto®?

Ok, but what IS Quarto®?

Quarto® is an open-source scientific and technical publishing system built on Pandoc

function Strong(elem)
  return pandoc.SmallCaps(elem.c)
end

quarto publish document.qmd     

Image: Kobby Mendez

Crafting a cocktail

“Crafting” process for literate programming

“Crafting” process for literate programming

“Crafting” process for literate programming

So what is a .qmd?

A Quarto document i.e. a .qmd is a plain text file, like a .rmd, that can be rendered to many different formats

Anatomy of a Quarto document

• Metadata (YAML)

format: html
engine: knitr

engine: jupyter #< for native Python/Julia without requiring R

```{r cars}
#| eval: false
mtcars |> 
  dplyr::group_by(cyl) |> 
  dplyr::summarize(mean = mean(mpg), .groups = "drop")
```

# Heading 1
This is a sentence with some **bold text**, some *italic text* and an [image](image.png).

So what is Quarto?

Quarto is a command line interface (CLI) that renders plain text formats (.qmd, .rmd, .md) OR mixed formats (.ipynb/Jupyter notebook) into PDF/Word/HTML reports, books, websites, presentations and more!

So what is Quarto?

One install, “Batteries included”

• Any language, same syntax and approach

Many Quarto formats

Built-in tabsets

```{r penguin-sum}
#| eval: false
library(dplyr, warn.conflicts=FALSE)
penguin_sum <- palmerpenguins::penguins |>
  group_by(species, sex) |>
  summarize(
    n = n(),
    across(
      c(body_mass_g, bill_length_mm, flipper_length_mm),
      list(
        mean = ~ mean(.x, na.rm = TRUE), 
        sd = ~ sd(.x, na.rm = TRUE)
      )
    ),
  )

penguin_sum
```

# A tibble: 8 × 9
# Groups:   species [3]
  species   sex        n body_mass_g_mean body_mass_g_sd bill_length_mm_mean
  <fct>     <fct>  <int>            <dbl>          <dbl>               <dbl>
1 Adelie    female    73            3369.           269.                37.3
2 Adelie    male      73            4043.           347.                40.4
3 Adelie    <NA>       6            3540            477.                37.8
4 Chinstrap female    34            3527.           285.                46.6
5 Chinstrap male      34            3939.           362.                51.1
6 Gentoo    female    58            4680.           282.                45.6
7 Gentoo    male      61            5485.           313.                49.5
8 Gentoo    <NA>       5            4588.           338.                45.6
# … with 3 more variables: bill_length_mm_sd <dbl>,
#   flipper_length_mm_mean <dbl>, flipper_length_mm_sd <dbl>

Figure Layout

::: {layout-nrow=2}
![Surus](surus.png)

![Hanno](hanno.png)

![Abdul Abbas](abdul-abbas.png)

![Lin Wang](lin-wang.png)
:::

Interactivity

• Quarto supports {htmlwidgets} and {shiny} in R or Jupyter Widgets for Python.

viewof bill_length_min = Inputs.range(
  [32, 50], 
  {value: 35, step: 1, label: "Bill length (min):"}
)
viewof islands = Inputs.checkbox(
  ["Torgersen", "Biscoe", "Dream"], 
  { value: ["Torgersen", "Biscoe"], 
    label: "Islands:"
  }
)

Plot.rectY(filtered, 
  Plot.binX(
    {y: "count"}, 
    {x: "body_mass", fill: "species", thresholds: 20}
  ))
  .plot({
    facet: {
      data: filtered,
      x: "sex",
      y: "species",
      marginRight: 80
    },
    marks: [
      Plot.frame(),
    ]
  }
)

Inputs.table(filtered)

data = FileAttachment("palmer-penguins.csv").csv({ typed: true })

filtered = data.filter(function(penguin) {
  return bill_length_min < penguin.bill_length &&
         islands.includes(penguin.island);
})

Next-Gen RMarkdown, unification

We learned from 10 years of literate programming with knitr + rmarkdown - Quarto is the continuation and unification of the best parts of RMarkdown via knitr.

RMarkdown and knitr are not going away, we’re still supporting it!

Next-Gen RMarkdown, extended for everyone

I feel as if R Markdown’s birth certificate had a letter “R” stamped on it, and Jupyter had a “Python” stamp - Yihui Xie (author of knitr) ¹

Collaboration between multi-lingual teams

¹

Photo by zero take

roam in color

Comfort of your own workspace

What to do with my existing .Rmd or .ipynb?

RMarkdown (and knitr) is not going away!

quarto render my-favorite.rmd --to html

quarto render my-favorite.ipynb --to html --execute

What to do with my existing .Rmd or .ipynb?

In fact, Quarto can help convert back and forth between .qmd and .ipynb:

quarto convert --help

Usage:   quarto convert <input>

Description:

    Convert documents to alternate representations.

  Convert notebook to markdown:                  quarto convert mydocument.ipynb                   
  Convert markdown to notebook:                  quarto convert mydocument.qmd                     
  Convert notebook to markdown, writing to file: quarto convert mydocument.ipynb --output mydoc.qmd

Quarto Publish

quarto publish --help

  Usage:   quarto publish [provider] [path]
  Version: 1.0.0                          
                                           
  Description:
    Publish a document or project. Available providers include:
                                                               
     - Quarto Pub (quarto-pub)                                 
     - GitHub Pages (gh-pages)                                 
     - RStudio Connect (connect)                               
     - Netlify (netlify)                                       
     
    Accounts are configured interactively during publishing.   
    Manage/remove accounts with: quarto publish accounts 

What about for Data Science at Work?

• Quarto can be used in the latest version of RStudio Team today!

Cocktails vs Mixed Drinks

Quarto, crafted with love and care

Development of Quarto is sponsored by RStudio, PBC. The same core team works on both Quarto and R Markdown:

• Carlos Scheidegger (@cscheid)

• Charles Teague (@dragonstyle)

• Christophe Dervieux (@cderv)

• J.J. Allaire (@jjallaire)

• Yihui Xie (@yihui)

Here is the full contributors list. Quarto is open source and we welcome contributions in our github repository as well! https://github.com/quarto-dev/quarto-cli.

Quarto

• Batteries included, shared syntax across output types and languages
• Choose your own editor and your preferred data science language
• More enhancements overtime - RMarkdown still maintained, but majority of new features built into Quarto

Follow @quarto_pub or me @thomas_mock on Twitter to stay up to date!